Skip to main content

Deploy a new version of your app

Prepare for Production​

Once the ads have been tested and are correctly integrated, it's time to prepare your app for production release:

Switch to Production Configuration​

  1. Replace Test IDs: If test placement IDs were used during development, replace them with your production application and placement IDs obtained in Get your configurations.

  2. Disable Test Mode and Verbose Logging: Ensure the test flag is set to false in your SDK initialization:

#include "x3mads/XMediatorAds.hpp"

// Production configuration - disable test mode and verbose logging
x3mads::InitSettings initSettings;
initSettings.test = false;          // Disable test mode for production
initSettings.verbose = false;       // Disable verbose logging for production

// Optional user properties
x3mads::UserProperties userProps;
userProps.userId.set("<your-user-id>");

x3mads::CustomProperties custom;
// Add your custom properties here
userProps.customProperties.set(custom);
initSettings.userProperties.set(userProps);

// Initialize SDK for production
x3mads::XMediatorAds::getInstance()->startWith(
    "<your-app-key>",
    initSettings,
    [](const x3mads::InitResult& result) {
        CCLOG("Production SDK initialized successfully!");
        // Start loading your production placements
    }
);
Production Checklist

Before deploying to app stores:

  • ✅ Set initSettings.test = false to disable test ads
  • ✅ Set initSettings.verbose = false to disable debug logging
  • ✅ Replace test placement IDs with production IDs
  • ✅ Remove debug-only code and logging
  • ✅ Test on physical devices with production configuration
  • ✅ Verify platform-specific requirements:
    • Android: Google Ads App ID in AndroidManifest.xml
    • iOS: SKAdNetwork IDs in Info.plist
  1. Review Configuration: Double-check that all placement IDs match your production setup in the admin panel.

Build Your App​

With the production configuration in place, build your app for release:

  • Remove debug flags and verbose logging
  • Test on physical devices to ensure everything works correctly
  • Verify ad loading and display in production mode

Deploy to App Stores​

Upload Your App​

With the integration complete and configurations switched to production, you're ready to upload the new version of your app to:

  • Google Play Store (Android)
  • Apple App Store (iOS)

Post-Deployment Monitoring​

After your app is live, monitor the performance of monetization, log in to the admin panel and access the dashboard section. There, you will find all the necessary information in real time.

Congratulations! 🎉

Thanks for trusting X3M! We're excited to help you succeed with your app's monetization.